home *** CD-ROM | disk | FTP | other *** search
/ NeXTSTEP 3.2 for Intel / NeXTSTEP 3.2 for Intel.iso / NextLibrary / Documentation / Sybase / DBLIB / Section2 / dbrpcsend.nr < prev    next >
Encoding:
Text File  |  1993-04-22  |  1.7 KB  |  55 lines
  1. .Na "dbrpcsend"
  2. .mc |
  3. .Aa
  4. .Fu
  5. Signal the end of a remote procedure call.
  6. .Ih "remote procedure call"
  7. .Ih "stored procedure, calling"
  8. .Ih "call, remote procedure"
  9. .Sy
  10. .Sf "RETCODE dbrpcsend(dbproc)"
  11. .Sp "DBPROCESS" "*dbproc"
  12. .Co
  13. .Bl
  14. An application can call a stored procedure in two ways:
  15. by executing a command buffer containing a \*N EXECUTE statement or by making a
  16. remote procedure call (``rpc'').
  17. See the manual page for \f2dbrpcinit()\f1 for a discussion of
  18. the differences between these techniques.
  19. .Bl
  20. To make a remote procedure call,
  21. first call \f2dbrpcinit()\f1 to specify the stored procedure that's to be invoked.
  22. Then call \f2dbrpcparam()\f1 once for each of the stored procedure's parameters.
  23. Finally, call \f2dbrpcsend()\f1 to signify the end of the parameter list.
  24. This causes the server to begin executing the specified procedure.
  25. You can then call \f2dbsqlok()\f1, \f2dbresults()\f1, and \f2dbnextrow()\f1
  26. to process the stored procedure's results.
  27. (Note that you will need to call \f2dbresults()\f1 multiple times if the
  28. stored procedure contains more than one SELECT statement.)
  29. After all of the stored procedure's results have been processed
  30. you can call the routines that process return parameters and status numbers,
  31. such as \f2dbretdata()\f1 and \f2dbretstatus()\f1.
  32. .Bl
  33. For an example of a remote procedure call, 
  34. see Example 8 in the \f2\*L Reference Supplement\f1.
  35. .Bz
  36. .Pa
  37. .Pi dbproc
  38. A pointer to the DBPROCESS structure that provides the connection
  39. for a particular front-end/server process.  It contains all the
  40. information that \*L uses to manage communications and data between the
  41. front end and the server.
  42. .in -.375i
  43. .Re
  44. .br
  45. SUCCEED or FAIL.
  46. .Sa
  47. dbnextrow,
  48. dbresults,
  49. dbretdata,
  50. dbretstatus,
  51. dbrpcinit,
  52. dbrpcparam, 
  53. dbsqlok
  54. .mc
  55.